home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / disk / fill605.zip / FILL.DOC < prev    next >
Text File  |  1996-05-10  |  21KB  |  431 lines
  1. FILL.DOC                             1                         Revised: 05/10/96
  2.  
  3. The FILL program is designed to help you move or copy  files  off  a  hard  disk
  4. while reducing the amount of wasted space on the destination disks.  Internally,
  5. it does this by sorting the file names so the  largest  files  are  moved/copied
  6. first.  It then moves or copies whatever files can fit on the  floppy,  skipping
  7. any that can't.  Features:
  8.  
  9.   * Can either move or copy the files to the resulting location.
  10.   * Can go onto to multiple diskettes as desired, beeping if desired when
  11.     the next disk is expected.
  12.   * Can move the files in file name order or any of standard ordering
  13.     categories.
  14.   * Can be used to split up files which are too big to fit on a single disk.
  15.   * Can create a status/transaction file for you, showing what was copied/moved.
  16.   * Can label the output diskette, providing some patterns like sequence numbers
  17.     and dates which it will fill in for you.
  18.   * Some times useful for network transfers where standard MOVE command doesn't
  19.     always work.
  20.   * Can review and delete if desired any files which are already in the
  21.     output destination (e.g. already on the output diskette).
  22.   * Can reformat the whole disk if files are going to drive A or B.
  23.   * Can specify an input file ("@listfile") which contains the files to be
  24.     copied.
  25.  
  26. Limits:
  27.   * Routine can only process the first 500 files found.  It ignores the rest of
  28.     them.  If you're using /MOVE, you can always run it after some of the
  29.     files are gone and get the rest of them that way.
  30.   * Routine can only review for deletion the first 200 files in the output
  31.     location.
  32.   * Routine does not provide any cool features to fix up destination drives
  33.     that have surface errors.  If it encounters an error, it just beeps, gives
  34.     you an error message, and returns to DOS.
  35.   * Routine will not format the output diskette for you.
  36.   * Switching diskette densities is not recommended (e.g. intermixing 720K
  37.     diskettes with 1.44MB diskettes may cause errors).
  38.   * The routine's ability to continually test for a new diskette (/CONT) only
  39.     works if the diskette was formatted using DOS 4.0 or later.  That's the
  40.     version that puts volume sequence numbers on the diskettes.  One way to
  41.     insure this if you're using the newer versions of DOS is to do a
  42.     quick-reformat of your floppies whenever you'd normally do a DEL A:*.*.  I
  43.     do this with a QDR.BAT command that has the following:
  44.  
  45.         FORMAT %1 /Q /U /V:Bruce
  46.  
  47.     I then say "QDR A:" or "QDR B:".  It invokes an unconditional quick format
  48.     and applies a volume label on the diskette (to avoid the prompt).  If the
  49.     diskette does not have a sequence number, DOS tells you it can't be
  50.     quick-formatted and asks if it can do the full format instead.
  51.  
  52.  
  53.  
  54. FILL.DOC                             2                         Revised: 05/10/96
  55.  
  56. Note on copying/moving files to multiple diskettes:
  57.  
  58. I didn't think this was confusing but a lot of people don't seem  to  understand
  59. the technique of how files are moved to multiple diskettes.
  60.  
  61. Let's say you have six files:
  62.  
  63.         A_FILE.ZIP      500K
  64.         B_FILE.ZIP      300K
  65.         C_FILE.ZIP      650K
  66.         D_FILE.ZIP      200K
  67.         E_FILE.ZIP      450K
  68.         F_FILE.ZIP       25K
  69.  
  70. You're moving these files to blank 1.2MB diskettes  and  you  have  the  default
  71. /MULTI and /ON settings.  The program checks how much space is available on  the
  72. destination drive and comes back with 1.2MB.
  73.  
  74. It scans the input files and internally sorts them by descending size.  It  then
  75. looks for the biggest file in the file list and comes back  with  C_FILE.ZIP  at
  76. 650K.  Will this file fit on the  destination  drive?   Yes.   It  retains  that
  77. information, figures there is now 550K left on the output drive, and checks  for
  78. the second biggest file.  A_FILE.ZIP is 500K.  Will that also fit?  Yes.  So now
  79. there's 50K left.  The next biggest file is E_FILE.ZIP at 450K.  Will that  fit?
  80. Nope.  Check the next  biggest.   This  continues  until  it  reaches  the  file
  81. F_FILE.ZIP which is only 25K.  That's the biggest file  that  will  fit  in  the
  82. remaining 50K.
  83.  
  84. So it has three files to move.  What order should it move them?   You  have  /ON
  85. set so it's going to move them in file name order.  So it  moves  the  following
  86. files in the following order:
  87.  
  88.         A_FILE.ZIP      500K
  89.         C_FILE.ZIP      650K
  90.         F_FILE.ZIP       25K
  91.  
  92. Next diskette.  Same process.  This time it processes the remaining files:
  93.  
  94.         B_FILE.ZIP      300K
  95.         D_FILE.ZIP      200K
  96.         E_FILE.ZIP      450K
  97.  
  98.  
  99. Specifying parameters:
  100.  
  101. Parameters for this program can be set in the following ways.  The last  setting
  102. encountered always wins:
  103.   - Read from an *.INI file (see BRUCEINI.DOC file),
  104.   - Through the use of an environmental variable (SET FILL=whatever), or
  105.   - From the command line (see "Syntax" below)
  106.  
  107.  
  108.  
  109. FILL.DOC                             3                         Revised: 05/10/96
  110.  
  111. Syntax:
  112.  
  113.     FILL [ filespec | @listfile ] [ [ /TO ] drive: | [ /TO ] drive:\path\ ]
  114.       [ /MOVE | /COPY ] [ /PROMPT ] [ /Iinitfile | /-I ]
  115.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  116.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE ] [ /MULTI | /SINGLE ]
  117.       [ /SPLIT ] [ /FORCE ] [ /-LETTER ] [ /LABEL=label [ /START=n ] ]
  118.       [ /Frptfile [ /S+ | /S- | S* ] [ /CONT ] [ /TIME ]
  119.       [ /-BEEP ] [ /-LAST ] [ /FAKE ] [ /Q ] [ /? ]
  120.  
  121. where:
  122.  
  123. "filespec" is the file specification for what you want to move.  You can specify
  124. a drive and path and file wildcards if  necessary  (e.g.   "C:\TEMP\*.BAT")  but
  125. otherwise it defaults to your default drive and directory and takes "*.*".  Note
  126. that the program cannot handle any request for more than 500 files at a time.
  127.  
  128. "@listfile" allows you to have a variety of file specifications saved in a  text
  129. file named "listfile".  You cannot have more than 50 file specifications in this
  130. file (and you're still limited to  the  500  files  total).   Each  line  should
  131. consist of a file name with optional drive and path  information.   Blank  lines
  132. and lines beginning with semi-colons, colons, or quotes are ignored.
  133.  
  134. "drive:" or "drive:\path" (or "/TO  drive:"  or  "/TO  drive:\path")  tells  the
  135. routine what drive or path to move the files to.  In  many  cases,  the  routine
  136. doesn't really care whether the source specification  precedes  or  follows  the
  137. destination specification.  If either parameter ends with a colon  (e.g.   "A:")
  138. or slash (e.g.  "C:\QB45\"), the routine will  presume  that's  the  destination
  139. specification and the other one must be the  source  specification.   If  either
  140. parameter contains a wildcard,  the  routine  will  presume  that's  the  source
  141. specification and the other one must be the destination specification.  So "FILL
  142. A:  *.BAS" is the same as "FILL *.BAS A:".  The use  of  the  "/TO"  keyword  is
  143. optional unless the  specification  is  being  provided  in  an  initfile.   The
  144. original default is "A:" (or "/TO A:").
  145.  
  146. "/MOVE" says to move the files instead of copying them.  Initially  defaults  to
  147. "/MOVE".
  148.  
  149. "/COPY" says to copy the files instead of moving them.   Initially  defaults  to
  150. "/MOVE".
  151.  
  152. "/PROMPT" says to prompt for each filename before moving it.  Initially defaults
  153. to "/-PROMPT".
  154.  
  155. "/-PROMPT" says to not prompt for each file.  Initially defaults to "/-PROMPT".
  156.  
  157. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  158. The file specification *must* contain a period.  Initfiles are described in  the
  159. BRUCEINI.DOC file.  Initially defaults to "/IFILL.INI".
  160.  
  161. "/-I" (or "/INULL") says to skip loading the initialization file.
  162.  
  163.  
  164. FILL.DOC                             4                         Revised: 05/10/96
  165.  
  166. "/OVERWRITE" says  to  overwrite  same-named  files  in  the  destination  path.
  167. Initially defaults to "/OVERSKIP".
  168.  
  169. "/-OVERWRITE" says to abort if any same-named files are found in the destination
  170. path.  Initially defaults to "/OVERSKIP".
  171.  
  172. "/OVERSK